<!-- Copyright 2014 The Chromium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file. -->

<link rel="import" href="/static/html/app-page.html">

<template>
  <app-page pageTitle="Documentation">

    <h1>Conventions</h1>
    <p>Some conventions were established in order to build requesters and
      build systems work together.</p>

    <h2>Buildset tag</h2>
    <p><code>buildset</code> tag is used to group related builds.</p>

    <p>If a build is related to a CL revision, buildset should have format:
      <ul>
        <li>For Rietveld: <code>
          patch/rietveld/<em>hostname</em>/<em>issue_id</em>/<em>patchset_id</em>
          </code></li>
        <li>For Gerrit: <code>
          patch/gerrit/<em>hostname</em>/<em>numeric_change_id</em>/<em>sha</em>
          </code></li>
      </ul></p>

    <p>When a build triggers a new build, the buildset tag must be copied.</p>

    <h2>Requester tag</h2>
    <p>Since there may be different build requester systems, you may want to
      distinguish builds by different build requesters. The <code>requester</code>
      tag is used for that reason. Known chrome-infra build requesters:
      <ul>
        <li><code>"cq"</code>: Chromium Commit Queue.</li>
        <li><code>"crbuild"</code>: <a href="http://crbuild.com">crbuild.com</a>.
          </li>
      </ul>

  </app-page>
</template>
